home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / language / clispdoc.zoo / INTRO.TXT
Text File  |  1992-04-11  |  4KB  |  111 lines
  1.                         Introduction to CLISP
  2.                         =====================
  3.  
  4. CLISP names this implementation of COMMON LISP for the Atari ST.
  5. It consists of the following files:
  6.  
  7. LISP.PRG           main program
  8. LISPINIT.MEM       memory image needed for startup
  9. CONFIG.LSP         site-dependent configuration
  10. INTRO.TXT          this introduction
  11.  
  12. What is LISP?
  13. -------------
  14.  
  15. LISP is a programming language. It was invented by J. McCarthy in 1959.
  16. There have been many dialects of it, but nowadays LISP has been standardized
  17. and wide-spread due to the industrial standard COMMON LISP. There are
  18. applications in the domains of symbolic knowledge processing (AI), numerical
  19. mathematics (MACLISP yielded numerical code as good as FORTRAN), and
  20. commercial programs like editors (EMACS) and CAD (AUTOCAD).
  21. There is an introduction in the language:
  22.   Sheila Hughes: Lisp. Pitman Publishing Limited, London 1986.
  23.   107 pages.
  24. After a while wou will need the standard text containing the language
  25. definition:
  26.   Guy L. Steele Jr.: Common Lisp - The Language. Digital Press.
  27.   1. edition 1984, 465 pages.
  28.   2. edition 1990, 1032 pages.
  29. LISP is run in an interactive environment. You input forms, and they will be
  30. evaluated at once. Thus you can inspect variables, call functions with given
  31. arguments or define your own functions.
  32.  
  33. Installation:
  34. -------------
  35.  
  36. Change the strings in CONFIG.LSP, using a text editor. Then start LISP.PRG.
  37. When the LISP prompt
  38.       > _
  39. appears, type
  40.         (compile-file "config")
  41.         (load "config")
  42. and then
  43.         (saveinitmem)
  44. to overwrite the file LISPINIT.MEM with your configuration.
  45. (Please do this only once!)
  46.  
  47. Things to know
  48. --------------
  49.  
  50. Keyboard input is line buffered.
  51. The following keys are recognized:
  52.   Tab                   1 to 8 spaces
  53.   Backspace             deletes one character to the left
  54.   Delete                deletes one character to the right
  55.   Insert                inserts a space
  56.   <-                    moves the cursor one character to the left
  57.   ->                    moves the cursor one character to the right
  58.   Shift <-              moves the cursor to the beginning of the line
  59.   Shift ->              moves the cursor to the end of the line
  60.   Return, Enter         finishes editing of this line
  61.   Help, Undo, F1-F10    context dependent
  62.  
  63. The loudspeaker bell sounds on every beginning and end of a garbage
  64. collection.
  65.  
  66. Screen output can be stopped temporarily by pressing the right mouse key.
  67. If the mouse is moved with the right mouse key being pressed, the screen
  68. output continues slowly.
  69.  
  70. Running programs can be interrupt in most cases by pressing both mouse keys
  71. at the same time. If this shouldn't work, simultaneous pressing of a shift
  72. key and both mouse keys will work.
  73.  
  74. You leave the LISP system by executing (exit).
  75.  
  76. When you encounter problems:
  77. ----------------------------
  78.  
  79. After errors, you are in the debugger:
  80.      1. Break> _
  81. You can evaluate forms, as usual. Furthermore:
  82.          Help
  83.                calles help
  84.          Undo
  85.                climbs up to next higher input loop
  86.          (show-stack)
  87.                shows the contents of the stack, helpful for debugging
  88. And you can look at the values of the variables of the functions where the
  89. error occurred.
  90.  
  91. On lack of memory (this is the case if garbage collections occur more and
  92. more often and you then get an error message) remove some memory pigs.
  93. If there is even not enough space to evaluate forms, then evaluate the form
  94. 0 three times and clean up or leave LISP using (exit).
  95. Hints to save memory: Don't leave programs in the background when starting
  96. LISP. Compile functions that have been tested enough.
  97.  
  98. On bigger problems, e.g. bombs, please send a description of the error and
  99. how to produce it reliably to the authors.
  100.  
  101. Authors:
  102. --------
  103.  
  104.         Bruno Haible                    Michael Stoll
  105.         Ritterstraße 42                 Riesenfeldstraße 96
  106.     D - W 7500 Karlsruhe 1          D - W 8000 München 40
  107.         Germany                         Germany
  108.  
  109. Email: haible@ma2s2.mathematik.uni-karlsruhe.de
  110.  
  111.